GitHub

2024-06-08 18:54| 来源: 网络整理| 查看: 265

Lightweight real-time collaborative editing on the Intranet!

The project has been archived. No further development work is being done on it

The etherdocs journey

Etherdocs, a fork from etherpad, comes with a huge codebase. It's all Javascript, frontend and backend. Work done so far that makes etherdocs different from beta.etherpad.org include:

Etherdocs is a huge codebase. Thankfully, it’s all javascript, so we’re familiar with it, but making changes to it is difficult. It is difficult to navigate. Despite that, work done so far that makes etherdocs different from beta.etherpad.org include:

Allowing for line breaks between numbered lists Dockerizing for use on Nectar Changed icons for most icons on toolbar based on artylope/etherdocs-prototype Using MySQL data store Settings in setting.json Landing page overhaul, thanks to @artylope Plugins in package.json modifying ep_font_size to allow for only even sizes and for up to size 32 modifying ep_headings2 to disallow heading 5 and 6 modifying ep_push2delete to hide it away from the toolbar in settings dropdown

Some of the things we tried that were not successful include:

Using etherpad-docker, because it uses OS level commands that are not permitted by Nectar Ep_bookmark, because it is very unintuitive for the user to enter a pad in order to see their other pads Ep_mypads, because it is huge and slowing us down Removing strikethrough functionality because we thought it was unused, only to add it back in a week later Using nodemon locally; kept giving “No module named ‘log4js’” no matter how I tried to npm install, remove cache, or uninstall Ep_copy_paste_images; buggy Getting started

docker-compose up --build

give it a whole bunch of time and then go to http://0.0.0.0:9001. When you are building it for something and you want it to run quicker, comment out the following lines in the Dockerfile:

RUN chmod -R g+rwx /usr RUN mkdir /.npm RUN chmod -R g+rwx /.npm

and the following line from the docker-compose.yml file:

user: "12345678:0"

I apologize but hot reloading is not available. You will need to stop the entire thing and restart it. It's very inefficient, I realize that :(

Those are included in here so that you are able to simulate the reduced permissions provided by Nectar when you are running your container

Things to take note of as a developer On Nectar, at build time, you are root user, but at runtime, you are a random user in the root group. This has important implications. Stuff like making directories or creating new files or even writing to files may not be possible any longer. For that reason, make sure to provide appropriate permissions, frontloading all the build steps, and preemptively creating the folders that might be needed Dockerfile's chmod -R g+rwx /usr is a very intensive operation. It has to modify every damn thing in th folder, and we have specified for it to happen recursively. If you have a lot of stuff in the directory (perhaps because, like myself, you have run the code on your machine instead of in a docker container, which creates a whole bunch of node_modules that bloats up your machine from 15MB to 80MB), it'll practically hang. Yes, you can create a .dockerignore file so that the Docker context is reduced, but I cannot be bothered. Run locally using docker because that's what happens in staging and prod. Acknowledgements

Many thanks to the creators of etherpad for their work

【本文地址】

公司简介

联系我们